home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / emulation / shapeshifter / extras / macjoy_1.1 / macjoy.doc < prev    next >
Encoding:
Text File  |  1995-08-17  |  5.6 KB  |  139 lines
  1.  
  2.           MacJoy V1.0 - 1995 by Francesco Doro (fdoro@gpnet.it)
  3.  
  4. Question:
  5.   What is this?
  6.  
  7. Answer:
  8.   This is mainly a joystick support for the Macintosh emulators Shape
  9. Shifter and Emplant (probably also A-Max IV but I couldn't test it).  Since
  10. there are a lot of Mac games that work well with these emulators, you may
  11. want to play them using your usual Amiga joystick.
  12.   It seems that joysticks are not very popular in the Mac world so all
  13. games have keyboard support; if you do something that translate joystick
  14. movements to key pressures the trick is done.
  15.   MacJoy does exactly this:  remap each Amiga-joystick movement to a key
  16. pressure; you can assign a key to each function of it so now you have a
  17. programmable joystick.
  18.   MacJoy has been tested on A500, A1200 and A4000/040; on my A4000 I
  19. tested MacJoy with both ShapeShifter and Emplant and other Amiga programs;
  20. I have not found a situation it doesn't work well.
  21.  
  22.  
  23. Question:
  24.   Which Amiga configuration does it require?
  25.  
  26. Answer:
  27.   Any Amiga with Workbench 2.0 or better.  Mac emulators may (do) require
  28. more specific configuration.
  29.  
  30.  
  31. Question:
  32.   How does it work?
  33.  
  34. Answer:
  35.   It's a commodity, it works in background receiving events from the
  36. gameport device and translating them to IDCMP_RAWKEY events; then these are
  37. sent to the input device, and finally to the active application.  If this
  38. application is a Macintosh emulator running Marathon, you will have a nice
  39. time...
  40.  
  41.  
  42. Question:
  43.   What about the installation?
  44.  
  45. Answer:
  46.   Simply drag it where you want in your workbench; a nice place is
  47. WBStartup since it's a commodity, but better you read below first.
  48.  
  49.  
  50. Question:
  51.   How do I use it?
  52.  
  53. Answer:
  54.   First of all, if you want to have a configurable joystick you must launch
  55. it from workbench.  MacJoy read his configuration from the ToolTypes stored
  56. in his icon; only if launched from workbench it will read these parameters.
  57. If launched from shell it will use a default configuration.  If you
  58. absolutely need to launch it from a shell or a script use 'Run >NIL:...'.
  59.   Now the hard part, the configuration:  select MacJoy's icon and open it
  60. with the 'info' of workbench icon menu.  You will see these six tooltypes:
  61. FIRE1, FIRE2, RIGHT, LEFT, DOWN, UP.  These are the usual and intuitive
  62. functions of an Amiga joystick; if your joy has only one fire-button ignore
  63. the FIRE2 tooltype.  Each tooltype is followed by a '=' and a *decimal*
  64. number that represents the *rawkey* code of the key that will be assigned
  65. to that function.  Be careful:  the rawkey code does NOT correspond to the
  66. ascii value of the character produced by that key.  In the MacJoy's archive
  67. you should have found an iff picture that will help you to write the
  68. correct code for each key.  MacJoy doesn't say nothing if you give him
  69. wrong parameters but it will ensure not to send to input device impossible
  70. codes.
  71.   MacJoy's default configuration is:  the four directions assigned to the
  72. cursor keys, first fire button to the space key and the the second to the
  73. right 'alt' key.  MacJoy will use this configuration if launched from shell
  74. or without tooltypes.
  75.   Most mac games can be configured to use your preferred keys so you can
  76. configure them according to the default MacJoy configuration or to the
  77. configuration you have made.  If this is not possible you can change the
  78. tooltypes of MacJoy but remember:  MacJoy is a commodity and does not have
  79. a graphic interface so you have first to remove it from memory with the
  80. Commodity Exchange or by re-launching it and after you can launch it again
  81. with the modified tooltypes.  You can do this while the emulation is
  82. running, this is not a problem in a multitasking environment.
  83.   Like every commodity MacJoy may be placed in the WBStartup drawer but be
  84. careful:  when active it makes joystick-keyboard conversion for the
  85. *active* application (but NOT for all tasks running) even if it's not a Mac
  86. emulator.  This probably makes it useful also for other applications or
  87. even for some Amiga games that don't support joystick, but you must know
  88. that moving joystick while MacJoy is active means pressing some keys of the
  89. keyboard (anyway it is NOT possible to reset Amiga with joystick).
  90. Probably the best is launching MacJoy before starting emulator or even
  91. before starting to play Mac games; at any moment you can go back to
  92. workbench and launch or remove MacJoy without quitting the emulator or the
  93. game you are playing.  Anyway if you don't move joystick MacJoy does
  94. absolutely nothing and doesn't take cpu time.
  95.   If your gameport has special hardware connected like dongles or network
  96. hardware (?), better not use MacJoy.
  97.  
  98.  
  99. Question:
  100.   Ok, have you any credits to give?
  101.  
  102. Answer:
  103.   YES!!! READ THIS:
  104.  
  105.   ********************************************************************
  106.   * MacJoy is based on the code of JoyRide V1.0, by Brian Koetting;  *
  107.   * he, very kindly, gave me the permission to use part of his code. *
  108.   ********************************************************************
  109.  
  110.   Tnx also to all emulators programmers.
  111.  
  112.  
  113. Question:
  114.   And the copyright?
  115.  
  116. Answer:
  117.   Well, the part of code ripped from JoyRide remains copyright by Brian
  118. Koetting (see the archive JoyRide.lha on Aminet).  My part is free...
  119.  
  120.  
  121. Question:
  122.   What if I find a bug or I want to suggest improvements?
  123.  
  124. Answer:
  125.   My e-mail address is fdoro@gpnet.it; if you find bugs try to explain the
  126. problem and I will try to fix it.  Don't ask improvements, ask emulators
  127. programmers to give real joystick support.  If MacJoy does what he says
  128. and it doesn't crash your Amiga, he does his job; enjoy it.  Stop.
  129.  
  130.  
  131. The Last Question:
  132.   Ahem...  do you speak english?
  133.  
  134. Answer:
  135.   No I don't, but believe me, I can write and speak italian very well.
  136.  
  137. :-)
  138.  
  139.